home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).adf / arp-pro1.3 / OLD_MANUAL / SyncRun < prev    next >
Text File  |  1990-06-22  |  3KB  |  132 lines
  1.  
  2.  
  3.  
  4.      SyncRun(33.4)      ARP Programmers Library     SyncRun(33.4)
  5.  
  6.  
  7.  
  8.      NAME
  9.       SyncRun -- Run a process and wait for    its completion.
  10.  
  11.      SYNOPSIS
  12.       rc = SyncRun(    "Filename", "args", Input, Output)
  13.        d0            a0          a1      d0     d1
  14.  
  15.      FUNCTION
  16.       SyncRun loads    a program from disk, searching the users Path
  17.       as set by the    Path command, runs it, and returns the exit
  18.       status of the    program    to you,    after first unloading the
  19.       program.  You    may set    the default Input and Output handles
  20.       for the new process, if you supply NULL, the new process
  21.       will inherit your processes default input and    output.
  22.  
  23.       This function    has been made as safe as possible, all task
  24.       private data stored before the new process gets your TCB,
  25.       and it is restored on    exit.  Furthermore, this function
  26.       cooperates with arp.library's    tracking functions to preserve
  27.       your ResList and resources as    well as    correctly handling the
  28.       new task's calls to the tracking functions, if any are made.
  29.  
  30.       BCPL programs    contain    bugs which cause them to be unable to
  31.       receive command lines    from this function.  All the programs
  32.       from the rest    of the world will receive their    command    lines
  33.       just fine, as    well BCPL programs when    they decide to join
  34.       the rest of us.
  35.  
  36.      INPUTS
  37.       "Filename" --    the filename of    the process you    wish to    load
  38.           and run.  The    directory search path will be searched
  39.           for this name.
  40.  
  41.       "Arguments" -- The arguments you wish    to pass    to this
  42.           process.  Note that the arguments are    passed without
  43.           parsing, so you should not expect io_redirection ( <
  44.           > ) to work.
  45.  
  46.       Input    -- The standard    input for the new process. If zero, it
  47.           will inherit your processes default input.  This
  48.           filehandle must be obtained and released by you.
  49.  
  50.       Output -- The    standard output    for the    new process.  If zero,
  51.           it will share    your processes default output. This
  52.           filehandle must be obtained and released by you.
  53.  
  54.      RESULT
  55.       If the return    from this function is positive or zero,    it is
  56.       the return code of the process executed.  ZERO means
  57.       successful termination.
  58.  
  59.       If the result    is negative, this function is returning    an
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SyncRun(33.4)      ARP Programmers Library     SyncRun(33.4)
  71.  
  72.  
  73.  
  74.       error    to you indicating that it could    not execute or load
  75.       the process.
  76.  
  77.      New for V33
  78.       This function    now releases memory chained into the task's
  79.       memlist by the child.     Any memory allocated by the parent is
  80.       of course not    freed until exit.
  81.  
  82.       This function    calls LoadPrg()    to obtain the segment to run.
  83.       This is a V33    function which searches    first the
  84.       ResidentList,    then the user speced path.
  85.  
  86.      SEE ALSO
  87.       LoadPrg(), UnLoadPrg(), AddResidentPrg(), ASyncRun()
  88.  
  89.      AUTHOR
  90.       SDB
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.      Page 2                         (printed 2/22/88)
  129.  
  130.  
  131.  
  132.